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* * *INTRODUCTION* * * 

This package allows you to easily edit and save a graphics 
mode 8 screen image. It also enables you to put standard 
graphics mode 0 (text) characters onto the image at machine 
speeds. Artifacting may be employed to produce multiple colors. 

All commands are entered with easy English statements, and 
numbers correspond to the standard graphics mode 8 window. 

Command format is easy to master and even if one forgets the 
name of a command, the help files will give a short form summary 
of all commands. 

The general form of commands is : 

Commandname arg1,arg2,arg3,arg4,arg5 
A space must follow the command name (all commands are one word) 
and each command has at least one argument. Arguments are 
integers that range from —99 to 999. Some of the commands have a 
dummy argument; the number after the command makes no 
difference, yet it is still required. This is similar to Atari 
Basic’s fre(n) or rnd(n) commands where n is simply a place 
holder. 


The Commands: 
BOX xl,yl,x2,y2 
CIRCLE x1,yl,rad,roundness 
CLEAR dummy 
CLOSEOUT dummy 
DIR driveno 
DISKERRORS dummy 
DRAW dummy 
ERASE dummy 
ERROROFF dummy 
FILER dummy 
FILL x1,y1,x2,y2,skip 
FULLSCREEN seconds 
GETSCREEN dummy 
HELP 

HIDESCREEN dummy 
LINE xl,yl,x2,y2 

POLYGON xl,yi,radius,sideno,rota 
SAVESCREEN dummy 
SETCOLOR reg,1urn,hue 
SHOWSCREEN dummy 
TEXT x1,yl 

TRIANGLE x1,y1,x2,y2,x3,y3 




tt* *** *** tt* *** *** *** *** *** 


REMOVE THE CARTRIDOE 

This disk is self booting. Just pull out the cartridge and 
put the disk in drive #1 and turn the computer on. 

NOTE: Many of the commands are not easily explained on 
paper, please try them out while reading this document!!! 

The graphics mode 8 screen has 320 positions horizontally 
and 192 positions vertically. When commands are entered that 
are in the lower portion of the screen you must use the 
fullscreen command to see the lower area covered by the text 
window. 


Remember that 0,0 is the upper left hand corner of your 
screen and 319,191 are the coordinates of the lower right hand 
corner. 

*** tt* *** tt* tt* tt* *** *** tt* 


BOX xl,yl,x2,y2 

The first two numbers are the coordinates of the upper left 
corner of the box and the second pair are the coordinates of the 
lower right hand corner. Try it !! 

CIRCLE x1,yl,rad,roundness 
xl and yl are the coordinates of the center of the 
circle, rad is the radius (in horizontal units), and roundness 
is the relative distortion from perfect round (1 is perfectly 
round, numbers <1 elongate in the Y direction and numbers >1 
enlongate in the X direction.) 


CLEAR dummy 

The clear command clears the entire graphics area, 
command is executed, there is no way to recall 
previously on the screen. Use it carefully!!! 

Dummy is just that !! A number >0 and <999 


Once this 
what was 



CLOSEOUT dummy 

This command closes the file previously created from input 
preceded with an (Please see notes at end for more 
details.) This command closes the file "OUT" that you have 
opened with a coomand preceded by an If you use closeout 
and then use a command with an "8<" preceding it the file "OUT" 
previously created will be deleted. (Use it only once!) 

DIR driveno 

Dir command allows you to see the directory of "driveno". 
Driveno is the number of the disk drive that you want a 
directory of: "Dir 1" will list all files on drive 1. If a 
nonsensical drive number is entered, an error will occur and you 
will have to wait for the O.S. to timeout. 


DISKERRORS dummy 

The default mode of error recovery is to simply print the 
error number that occured and to ignore the command (or 


situation). When this command is entered, a one line error 
message is printed to the screen in English. This mode is active 
until the ERRORDFF command is executed. 

Please note the disk in drive 1 must have the helpl and 
help2 -Files on it for this to work !! 

DRAW dummy 

Draw sets up the color register (2) to draw (see erase) . 

ERASE dummy 

Erase changes the color register so that any postion covered 
by any command in erase mode will erase to the default black 
background.The prompt character ( > ) is inverse—video in erase 
mode. 


ERROROFF dummy 

Turns off long error messeges that were turned on by a 
DISKERROR command. 

FILER dummy 

Filer allows the Graphics Machine to get commands from the 
disk. After entering this command FILER prompts for a file name. 
At this point all input is from that file until the end of file 
is reached. If diskerrors is toggled on then the file DEROR must 
also be on the disk in drive one. Also, if the source file has 
errors or bad commands in it you will see it send junk to the 
screen !! (Don’t say I didn’t warn you.) 

FILL x1,yl,x2,y2,skip 

FILL allows you to fill in areas of the screen with white, 
black, blue and red. The xl,yl,x2,y2 are the same as in the BOX 
command ( so look there !!) skip is the number of graphics mode 
8 lines to skip horizontally. This fill goes from top to bottom 
, not left to right as in the XIO fill. Try a skip value of two 
and then do a fill with a value of x1 that is even, then try it 
with an xl value that is odd !!! So that’s what artifacting is 
!!! This also works in erase mode !! 

For further information on artifacting please see recent 
publications from ATARI. 

FULLSCREEN seconds 

Shows you the entire graphics screen without the text window 
at the bottom. Note that the number of seconds that you enter is 
how long it will remain in this state. Because everyone seems to 
put in numbers way to big, you may press any key while in this 
state and it will revert back to normal mode. You can put in 999 
and not have to wait 16 hours !!! 

GETSCREEN dummy 

Getscreen pulls in the entire graphics screen from the disk. 
This command will prompt for the file name, up to eight 
characters are allowed because SAVESCREEN appends a ".SCR". You 
will find that this command is a very fast way to retrieve a 
screen! 


HELP 



If the word "HELP" is anywhere on the command line the two 
help files helpl and help2 are displayed. These files are only 
to refresh your memory on the syntax of the commands; These 
files are quite terse and are not for learning this system ( I 
say this so you who have immediately put the disks in and are 
frustrated don’t scream at me !!!) 

HIDESCREEN dummy 

This command pokes the antic off. It will hide the display 
while commands are entered from disk or keyboard. To turn the 
screen back on use SHOWSCREEN. 

LINE xl,yl,x2,y2 

LINE draws a line between any two points;xl and yl are the 
coordinates of the first point and x2,y2 are the coordinates of 
the second point. 

POLYGON x1,yl,radius,sideno,rota 

Polygon draws shapes centered around xl,yl with a radius of 
"radius" (in x units),having "sideno” number of sides. The 
"rota" is the rotation angle in degrees. (Try it !!!) Zero 
degrees is at position x1+radius,yl (over to the right by one 
radius). 


SAVESCREEN dummy 

This command will save the contents of the entire graphics 
mode 8 screen. It will prompt for a file name (up to eight 
characters a ".SCR" is appended.) Note that this takes 62 disk 
sectors so be sure the disk has room with the DIR command. 

SETCOLOR reg,1um,hue 

Changes the color register as per the ATARI BASIC MANUAL 
(page SO). 


SHOWSCREEN dummy 

Turns on the antic, see HIDESCREEN. Note that after 
executing a HIDESCREEN command using SHOWSCREEN is the only way 
to see the screen again (ie use it carefully). 

TEXT x1,yl 

This command will put text characters onto your screen 
(fast!!!). Both xl and yl are relative to the graphics mode 0 
screen, ie yl is the graphics mode 0 row number, xl is however a 
little more complicated. If xl is less than 40 then it is the x 
position. If it is greater than 40 and less than 80 then the 
text will be moved one pixel down. In any case xl must be less 
than 255. This allows complete control over the position of text 
objects. See the examples on disk. 

TRIANGLE x1,y1,x2,y2,x3,y3 

Draws a line between the three specified points. Note that 
polygon can also draw triangles. 


*** »** NOTES *** * * * 
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